home *** CD-ROM | disk | FTP | other *** search
/ Best of Shareware / Best of PC Windows Shareware 1.0 - Wayzata Technology (7111) (1993).iso / pc / dos / business / tickle70 / tickler.doc < prev    next >
Text File  |  1991-04-10  |  29KB  |  536 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                    TICKLER & TICKUTL DOCUMENTATION VERSION 7.0
  23.                           (C) copyright 1991 Lynn Canning
  24.                               9107 Grandview Dr.
  25.                             Overland Park, KS 66212
  26.                                  (913) 649-7334
  27.  
  28.                                                               TICKLER Page 2
  29.  
  30.  
  31.       TICKLER            TICKLER is an enhanced appointment calendar
  32.       Features           which includes the following functions:
  33.                          - Provides an on-screen list of your schedule.
  34.                          - Provides a printed listing of your schedule
  35.                            for a specified number of days.
  36.                          - Allows messages to be tagged as recurring
  37.                            annually, quarterly, monthly occurance,
  38.                            monthly, weekly, 30, 60, 90 day or temporary.
  39.                          - Temporary messages are automatically purged
  40.                            when past the effective date and are saved
  41.                            for future reference.
  42.                          - Provides a printed listing of purged messages.
  43.                          - Provides on screen viewing of purged messages.
  44.                          - Provides full on-screen edit capabilities.
  45.                          - Provides the ability to check your schedule
  46.                            for a specified date.
  47.  
  48.  
  49.       TICKUTL            TICKUTL is a memory resident program that provides
  50.       Features           the following functions:
  51.                          - Add editor for TICKLER.
  52.                          - Perpetual calendar.
  53.                          - Printer setup for Epson and AT&T printers.
  54.                          - Printer setup for HP Laserjet printers.
  55.                          - Screen counter utility.
  56.                          - Area Code Finder.
  57.                          - ASCII Chart.
  58.  
  59.       Hardware           These programs have been tested on an IBM/PC using
  60.       Restrictions       PC-DOS 3.1 and on an AT&T 6386/SX using MS-DOS 3.3.
  61.  
  62.                          Routines have been included in the programs which
  63.                          should automatically handle monochrome monitors,
  64.                          but they have not been tested.  Monochrome monitors
  65.                          are therefore not supported although they may in
  66.                          fact work properly.
  67.  
  68.                                                               TICKLER Page 3
  69.  
  70.  
  71.       Manual             TICKLER should be inserted into your AUTOEXEC.BAT
  72.       Installation       file, so that your schedule will automatically
  73.       for Hard Disk      be displayed on power up.  Tickler can also be run
  74.                          at anytime from the DOS prompt.
  75.  
  76.                          STEPS for installation on hard disk:
  77.                          - Make a directory called TICKLIB
  78.                            DOS entry is md\ticklib
  79.                          - Go to the ticklib directory
  80.                            DOS entry is cd\ticklib
  81.                          - Copy the TICKLER files to the ticklib
  82.                            directory.
  83.                            DOS entrys are:
  84.                            copy a:tickler.com
  85.                            copy a:tickler.dat
  86.                            copy a:tickutl.com
  87.                            copy a:tickutl.000
  88.                          - Go to the main directory
  89.                            DOS entry is  cd\
  90.                          - Edit the autoexec.bat file.
  91.                              Include c:\ticklib in the path statement.
  92.                              Insert the following lines:
  93.                                set ticklib=c:\ticklib
  94.                                tickler a
  95.                                tickutl
  96.                              The set command will cause TICKLER and
  97.                              TICKUTL to look for their files in the
  98.                              ticklib directory.
  99.                              NOTE:  See Removing TICKUTL from memory in the
  100.                                section on TICKUTL.
  101.                          - If are currently using tickler, you will
  102.                            probably want to copy the existing tickler.dat
  103.                            and tickler.old files to the ticklib directory.
  104.  
  105.  
  106.       Mechanized         The TICKLER install program will automatically
  107.       Installation       do everything described in the manual installation
  108.       for Hard Disk      section including copying existing tickler.dat and
  109.                          tickler.old files.  If an existing tickler.dat file
  110.                          is found, it is concatenated to the tickler.dat
  111.                          file on the program floppy and placed in the
  112.                          ticklib directory.
  113.  
  114.                                                               TICKLER Page 4
  115.  
  116.  
  117.       Command Line       There are four command line parameters that can be
  118.       Parameters         specified in any order, but must be separated by a
  119.                          space.
  120.  
  121.                          "C" - TICKLER will automatically assume you are
  122.                            using a color monitor.  If you are using a
  123.                            monochrome monitor or a composite monochrome
  124.                            monitor such as is found on many portables, the
  125.                            screen colors can be changed to shades of black
  126.                            and white by setting a command line parameter of
  127.                            "C" when calling the program.
  128.                              Example: TICKLER C <cr>.
  129.  
  130.                          "A" - Automatic no-show.  In normal mode, TICKLER
  131.                            pauses after displaying the initial window until
  132.                            a key is pressed.  In no-show mode, if no
  133.                            messages are available to show on the screen,
  134.                            TICKLER writes a "No Messages Available" line
  135.                            and exits.  This option should be included in
  136.                            your autoexec.bat as it will not cause a pause
  137.                            in your boot up if there are no messages to be
  138.                            displayed.
  139.                              Example: TICKLER A <cr>
  140.  
  141.                          "mm/dd/yy" - TICKLER displays messages based on
  142.                            the current date.  If a date is specified on the
  143.                            command line, Tickler will show the messages
  144.                            available for that date.  No editing is allowed
  145.                            when this special date is specified.
  146.                              Example: TICKLER 10/20/90 <cr>
  147.  
  148.                          "S" - Print Schedule.  Tickler will print a
  149.                            schedule of messages available.  This option
  150.                            also works with a special date in the command
  151.                            line.  TICKLER will ask for the schedule time
  152.                            span.  Up to 99 days can be entered.
  153.                              Example: TICKLER C S <cr> or TICKLER S <cr>
  154.  
  155.                          A command line of TICKLER C S 10/20/90 would set
  156.                          the black and white monitor settings, call up the
  157.                          schedule for 10/20/90, and print a selected
  158.                          schedule for that date.
  159.  
  160.                                                               TICKLER Page 5
  161.  
  162.  
  163.       TICKLER            Typing an "E" at TICKLER's opening screen will
  164.       Editor             cause the TICKLER edit menu to be displayed.
  165.       Features           The following functions are available:
  166.                          - Add a message
  167.                          - Modify an existing message
  168.                          - Print the purged file
  169.                          - Delete the purged file
  170.                          - View the purged file
  171.  
  172.                          The data files are maintained in text format so
  173.                          that they can be listed or printed with standard
  174.                          utilities.  Caution should be used if attempting
  175.                          to make modifications with a word processers,
  176.                          since some of them set end of line and end of file
  177.                          marks that make the file unreadable.
  178.  
  179.                          TICKLER determines message status by comparing the
  180.                          system julian day to the message julian day.  This
  181.                          is not a true julian day because Tickler always
  182.                          assumes 366 days in a year.
  183.  
  184.  
  185.       Editor             The editor utilizes the following keys:
  186.       Keys                 left arrow
  187.                            right arrow
  188.                            home
  189.                            end
  190.                            backspace
  191.                            Esc
  192.  
  193.  
  194.       Editor             The editor is always in insert mode.  It requests
  195.       Usage              you to supply input to a particular field and then
  196.                          press return.  If you want to use the default
  197.                          value for a field, just press return.  If you
  198.                          make a mistake, you cannot back up to a previous
  199.                          field.  Pressing the Esc key will allow you to
  200.                          escape from the entry mode and start over or exit
  201.                          the editor.  After all fields are input, you are
  202.                          asked if you want to save the message.  If a
  203.                          mistake has been made, just say no and re-enter
  204.                          the data.
  205.  
  206.                          It is not necessary to type leading zeros when in
  207.                          the editor.  Since the editor is always in insert
  208.                          mode, be sure to check any changed values before
  209.                          pressing the return key.
  210.  
  211.                                                               TICKLER Page 6
  212.  
  213.  
  214.       TICKLER            Month     - valid values are 1-12.
  215.       Add                Day       - valid values are 1-31.
  216.       Editor             Year      - four position year, default is current
  217.       Option "A"                     year.
  218.                          Time      - format is hh:mm, default is spaces.
  219.                          AM/PM     - enter AM or PM, default is spaces.
  220.                                      This field is required if a time was
  221.                                      entered.
  222.                          Msg Line1 - 50 characters, default is spaces.
  223.                          Msg Line2 - 50 characters, default is spaces.
  224.                          Timespan  - the number of days in advance you wish
  225.                                      the message to appear.  An entry of 00
  226.                                      causes the message to appear only on
  227.                                      the message day.  99 days is the
  228.                                      maximum entry.  Default is 00.
  229.                          Status    - A = Annual.  Message will show once a
  230.                                      year on the day specified.  Good for
  231.                                      birthdays.
  232.                                      Q = Quarterly.  Message will show on
  233.                                      the day specified on the first month
  234.                                      of each quarter.  Message month must
  235.                                      contain the first month of one of the
  236.                                      quarters.
  237.                                      O = Monthly Occurance.  Message will
  238.                                      show on the day of the week and
  239.                                      occurance specified. ie. Second
  240.                                      Tuesday, third Friday.
  241.                                      M = Monthly.  Message will show every
  242.                                      month on the day specified.  Message
  243.                                      month is ignored but must contain a
  244.                                      valid value.
  245.                                      W = Weekly.  Message will show on the
  246.                                      day of the week specified.  Message
  247.                                      day and month are ignored, but must
  248.                                      contain a valid value.
  249.                                      T = Temporary.  Message will show on
  250.                                      the day specified.  Good for meetings.
  251.                                      3 = Message shows every 30 days.
  252.                                      6 = Message shows every 60 days.
  253.                                      9 = Message shows every 90 days.
  254.                          DOW       - Enter day of week to show message.
  255.                                      1 = Sunday, 2 = Monday, etc.
  256.                          OCC       - Enter occurance in month to show the
  257.                                      message.  Valid values are 1 - 4.
  258.  
  259.                          Note:  Message date on Quarterly, Monthly, Monthly
  260.                                 Occurance, and Weekly messages are
  261.                                 recalculated each time Tickler is run.
  262.                                 Only the first occurance of these message
  263.                                 types will be shown on the printed schedule.
  264.  
  265.                                                               TICKLER Page 7
  266.  
  267.  
  268.       TICKLER            When this option is selected, all messages are
  269.       Modify             displayed on the screen.  The currently selected
  270.       Editor             message is high-lighted.  Use the up and down
  271.       Option "M"         arrow keys to select the message to be changed or
  272.                          deleted.  When the message is selected, press C to
  273.                          change or D to delete.
  274.  
  275.                          CHANGE  - This is just like the Add Editor except
  276.                          the current values are shown.  If a particular
  277.                          field requires no change, press return and the
  278.                          current value is kept.
  279.  
  280.                          DELETE  - This causes the selected message to be
  281.                          deleted.  The message is not actually deleted
  282.                          until end of job.  If you accidently delete a
  283.                          message, you can undelete it by typing "D" again
  284.                          and the delete status will be toggled off.
  285.                          Deleted messages are not written to the purged
  286.                          messages file.
  287.  
  288.  
  289.       Print              Selection of this option causes the printing of
  290.       Purged             the TICKLER.OLD file which contains all purged
  291.       Messages           temporary messages.  Since the printing is not
  292.       Option "P"         started until just before end of job, this option
  293.                          can be toggled on and off.
  294.  
  295.       Delete             Selection of this option causes the deletion of
  296.       Purged             the TICKLER.OLD file.  Since the file is not
  297.       Messages           deleted until just before end of job, this option
  298.       Option "O"         can be toggled on and off.
  299.  
  300.       View               Selection of this option allows on-screen viewing
  301.       Purged             of the TICKLER.OLD file which contains all purged
  302.       Messages           temporary messages.
  303.       Option "V"
  304.  
  305.                                                               TICKLER Page 8
  306.  
  307.  
  308.       Calling            The Tickler Utility Menu is popped up by typing
  309.       TICKUTL            (Alt)= after it has been loaded into memory.  Any
  310.                          of the options shown may then be selected by
  311.                          typing the corresponding number or letter key.
  312.                          The options are various utilities which upon
  313.                          completion will exit Tickler Utilities and return
  314.                          to the previous task.
  315.  
  316.  
  317.       TICKUTL            This utility is a memory resident add editor for
  318.       Add                TICKLER.  It operates identically to the add
  319.       Editor             editor in TICKLER.  The utility allows you to
  320.                          add messages to your schedule without exiting
  321.                          from a running application program.  Refer to the
  322.                          TICKLER documentation for detailed instructions on
  323.                          the use of the TICKLER Editor.
  324.  
  325.  
  326.       TICKUTL            This program will show three months of calendars
  327.       Calendar           with the target month in the middle.  Upon
  328.                          selection, the calendars associated with the
  329.                          system month are initially displayed.  The program
  330.                          will then ask for a different target month and
  331.                          year.  If the target month desired is in the
  332.                          current year, it is not necessary to enter the
  333.                          year.
  334.  
  335.                          This is a perpetual calendar and will display any
  336.                          year  greater than 0100.  Entries less than year
  337.                          0100 or that do not contain a century will have
  338.                          1900 added to the year.  Keep in mind that several
  339.                          centuries ago several days were added to the
  340.                          Gregorian calendar thus invalidating the calendars
  341.                          shown for very old dates.
  342.  
  343.                                                               TICKLER Page 9
  344.  
  345.  
  346.       Epson/AT&T         This utility is mostly self explanatory.  Various
  347.       Printer            print options are turned on an off through the use
  348.       Set-up             of a menu.  It will work with most Epson and Epson
  349.                          compatible printers.  Several parameter exceptions
  350.                          have been flagged as unavailable for use with the
  351.                          noted AT&T printers.  It is advisable to consult
  352.                          your printer manual to determine if all of the
  353.                          options shown are compatible with the printer you
  354.                          are using.
  355.  
  356.                          When this utility is called, the printer is reset
  357.                          to its power up state thus cancelling all
  358.                          previously set parameters.  Various options can be
  359.                          set by typing the corresponding number or letter.
  360.                          Options previouly set can be turned off by typing
  361.                          the number or letter key again.  Multiple options
  362.                          may be selected yielding a large range of print
  363.                          styles.  Some options are incompatible with other
  364.                          options.  For example emphasized mode cannot be
  365.                          used with elite type and obviously you cannot set
  366.                          multiple line spacing parameters.  See your printer
  367.                          manual for any combinations that do not seem to
  368.                          work properly.
  369.  
  370.                          After the options are set, you can see the results
  371.                          by printing a test pattern.  This pattern also
  372.                          denotes the options selected.  Try option "K" for
  373.                          if you have good eyes and want to save some paper.
  374.  
  375.  
  376.       HP Laser           This utility is similar to the Epson printer set up
  377.       Printer            option.  Due to the many options and configurations
  378.       Set-up             available on the laser printer, some options shown
  379.                          may not work properly on a particular machine.
  380.  
  381.                                                              TICKLER Page 10
  382.  
  383.  
  384.       Screen             Screen Counter was written to count screen
  385.       Counter            positions.  When Screen Counter is activated you
  386.                          will notice four counters on the last line of the
  387.                          screen.  The line counter obviously tells you what
  388.                          line you are on and correspondingly the column
  389.                          counter gives you the column or your position on
  390.                          the line.  The trip counters are used to determine
  391.                          the horizontal and vertical distance between two
  392.                          points on the screen.  Note that the column and
  393.                          line counters correspond to the X and Y screen
  394.                          coordinates respectively.  This is particularly
  395.                          helpful when designing a screen layout.
  396.  
  397.                          To use the trip counters, place the cursor on the
  398.                          leftmost point that you wish to begin counting.
  399.                          Type the F2 key to reset the trip counters to 1.
  400.                          Move the cursor to the rightmost point.  The htrip
  401.                          counter now contains the horizontal distance
  402.                          between the two points including the starting and
  403.                          ending positions.  The vtrip counter contains the
  404.                          vertical distance between the starting and ending
  405.                          points.
  406.  
  407.                          The trip counters count from left to right and top
  408.                          to bottom.  If you overshoot your target position,
  409.                          you can move the cursor to the right or up and the
  410.                          counters will decrement.  The trip counters will
  411.                          reset to the value of the column and line  counters
  412.                          if you attempt to drive them to a negative value by
  413.                          moving left or up past the starting position.
  414.  
  415.                          Cursor movement is controlled by the number pad
  416.                          keys.  For details, see the on-screen help menu by
  417.                          pressing the F1 key when in the program.  The
  418.                          cursor will screen wrap except when attempting to
  419.                          go left at line 1 column 1 or right at line 24
  420.                          column 80.
  421.  
  422.       Area Code          If an area code is entered, a list of major cities
  423.       Finder             for the area code is shown.  If a two position
  424.                          postal state code is entered, a list of area codes
  425.                          and major cities for the area codes is shown.  If
  426.                          a ? is entered, the postal state code is shown for
  427.                          each state.
  428.  
  429.       ASCII Chart        A screen is displayed showing the ASCII characters.
  430.  
  431.                                                              TICKLER Page 11
  432.  
  433.  
  434.       Removing           Tickler Utilities can be removed from memory by
  435.       TICKUTL            typing Ctrl-F9 when the Tickler Utility Menu is on
  436.       From               the screen.  Tickler Utilities must not be removed
  437.       Memory             unless it was popped up at the DOS prompt.
  438.                          Attempting removal when Tickler Utilities is popped
  439.                          over an application program will most likely result
  440.                          in a system crash.  If Tickler Utilities is not the
  441.                          last memory  resident program loaded, the other
  442.                          programs must be removed first or the memory used
  443.                          be Tickler Utilities will not be released leaving a
  444.                          hole in memory that will remain unaccessable until
  445.                          the system is rebooted.
  446.  
  447.  
  448.       TICKLER            TICKLER determines message status based on the
  449.       Problems           system date.  The system date is displayed on the
  450.                          opening screen.  Make sure the date is correct or
  451.                          some temporary files may incorrectly be purged.
  452.  
  453.  
  454.       TICKUTL            As is the case with many memory resident programs,
  455.       Problems           TICKUTL may be incompatible with some programs.
  456.                          If problems occur, try changing the order that you
  457.                          load your memory resident programs.  If this does
  458.                          not solve the problem, it would probably be best
  459.                          to only load TICKUTL when it will not be in
  460.                          contention with the other program involved.
  461.  
  462.  
  463.       TICKUTL            TICKUTL is not a requirement for running TICKLER.
  464.       Note               The only connection it has with TICKLER is the
  465.                          memory resident add editor.  TICKLER contains
  466.                          exactly the same editor internally, it is just not
  467.                          memory resident.
  468.  
  469.                                                              TICKLER Page 12
  470.  
  471.  
  472.       TICKLER            The following files should be present on the
  473.       Files              program floppy:
  474.                          TICKLER.COM - Program file for TICKLER
  475.                          TICKLER.DAT - TICKLER's message file
  476.                          TICKUTL.COM - Program file for TICKUTL
  477.                          TICKUTL.000 - Overlay program file for TICKUTL
  478.                          TICKLER.DOC - Documentation for TICKLER & TICKUTL
  479.  
  480.  
  481.  
  482.       TICKLER            TICKLER.DAT - Current messages are added to and
  483.       Data               maintained in this file.  TICKLER will look for
  484.       File               this file in the directory specified by the SET
  485.       Descriptions       command.  If not found, you will be asked for the
  486.                          drive and directory where TICKLER.DAT resides.
  487.                          This file must be present.
  488.  
  489.                          TICKLER.OLD - Temporary files older than the
  490.                          system date are automatically purged and saved for
  491.                          future reference in this file.  This file is
  492.                          provided to allow you to review which meetings
  493.                          you have attended, etc.  Print, delete, and view
  494.                          options for this file are contained in the editor
  495.                          menu.  TICKLER assumes that TICKLER.OLD resides on
  496.                          the same drive and directory as TICKLER.DAT.
  497.                          TICKLER will automatically create this file when it
  498.                          is needed.
  499.  
  500.                          TICKLER.$$$ - This is an work file which is erased
  501.                          at end of job.  If for some reason TICKLER
  502.                          abnormally terminates, this file may not be erased,
  503.                          and should be manually deleted.
  504.  
  505.                                                              TICKLER Page 13
  506.  
  507.  
  508.       Registration       This program is distributed for personal, private
  509.                          use and with the understanding that if it is used
  510.                          and found to be of value, the user will register
  511.                          with a contribution of $15.
  512.  
  513.                          Commercial and corporate use without registration
  514.                          and license is prohibited.
  515.  
  516.                          Multiple copy rates are as follows:
  517.                          Number of users (copies)    Price per copy
  518.                             1   to 9                  $ 15.00
  519.                             10  to 25                   12.00
  520.                             26  to 100                  10.00
  521.                             101 to 250                   7.50
  522.                             251 to 500                   5.00
  523.                             501 to 1000                  2.50
  524.                             1001 up                      1.25
  525.  
  526.                          Regardless of the quantity, only one set of
  527.                          materials will be sent to you.  You may then make
  528.                          as many copies as required.
  529.  
  530.                          Make checks payable to and address questions and
  531.                          problems to:
  532.                          Lynn Canning
  533.                          9107 Grandview Drive
  534.                          Overland Park, KS 66212
  535.                          Phone (913) 649-7334
  536.